Micron Document
πŸŽ–οΈGitΠ―Ρ€Π°πŸŽ–οΈ


Displaying Rendered β€’ View raw β€’ Download

docs/et-rEE/user/mqtt.md ce1a9fca2b7beae317db6f59d76ebb652ca332f6 (ce1a9fca) Text, 7.15 KB

title: MQTT
parent: User Guide
nav_order: 11
last_updated: 2026-05-13
description: Silda oma vΓ΅rk internetiga – MQTT maakleri seadistamine, krΓΌpteerimiskihid ja kaardiaruandlus.
aliases:
β€’ mqtt
β€’ internet-bridge
β€’ broker

MQTT

MQTT ΓΌhendab Meshtastic vΓ΅rgu internetiga, vΓ΅imaldades raadiolevi ulatusest kaugemale ulatuvat pikamaasidet.

Overview

MQTT moodul ΓΌhendab sinu sΓ΅lme MQTT vahendajaga, vΓ΅imaldades:

β€’ Messages to reach nodes on different physical meshes via the internet
β€’ Integration with home automation and monitoring systems
β€’ SΓ΅lmede asukoha avaldamine avalikul Meshtastic kaardil
β€’ Custom data pipelines for logging and alerting

How It Works

T282828
[Sinu sΓ΅lm] β†’ Raadio β†’ [WiFi-ga lΓΌΓΌsisΓ΅lm] β†’ MQTT vahendaja β†’ [KauglΓΌΓΌs] β†’ Raadio β†’ [KaugsΓ΅lm]

InternetiΓΌhendusega (WiFi vΓ΅i Ethernet) lΓΌΓΌsisΓ΅lm jagab vΓ΅rgusΓ΅numeid MQTT. Remote gateways subscribed to the same topic inject those messages into their local mesh.

SΓ€tted

Luba MQTT

1. Mine menΓΌΓΌsse Seaded β†’ Mooduli konfiguratsioon β†’ MQTT.
2. Luba MQTT moodul.
3. Configure the broker connection:


β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ SΓ€tted β”‚ Kirjeldus β”‚ Vaikimisi β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Server Address β”‚ MQTT vahendaja hostinimi β”‚ mqtt.meshtastic.org β”‚
β”‚ Kasutajatunnus β”‚ Broker authentication β”‚ meshdev β”‚
β”‚ Parool β”‚ Broker authentication β”‚ large4cats β”‚
β”‚ Root Topic β”‚ Base topic for messages β”‚ msh β”‚
β”‚ Encryption β”‚ KrΓΌpteeri MQTT liiklus β”‚ Lubatud β”‚
β”‚ ~~JSON vΓ€ljund~~ β”‚ ⚠️ Vananenud β€” JSON pakettide tugi on pΓΌsivarast eemal… β”‚ Keelatud β”‚
β”‚ TLS β”‚ Secure connection to broker β”‚ Keelatud β”‚
β”‚ Map Reporting β”‚ Report position to public map β”‚ Keelatud β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Meshtastic vaikemaakler

Kogukond haldab avaliku vahendajat aadressil T383838mqtt.meshtastic.org. This is intended for general use and testing.

β”‚ πŸ”’ Privaatsus: Avaliku vahendaja sΓ΅numeid saavad lugeda kΓ΅ik tellijad. Always use channel
β”‚ encryption for private communications.

Private Broker

Parema privaatsuse ja kontrolli tagamiseks saad hallata oma MQTT maaklerit:

β€’ Mosquitto (lightweight, open-source)
β€’ HiveMQ
β€’ EMQX

Configure your node to point to your private broker with appropriate credentials.

Map Reporting

Kui kaardiaruandlus on lubatud, avaldab sΓ΅lm oma asukoha Meshtasticu kogukonnakaardil:

β€’ Visible at meshmap.net and similar community map services
β€’ Only position and node info are shared
β€’ Disable this if you don't want your location publicly visible

Üleslink vs allalink

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Direction β”‚ Kirjeldus β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Üleslink β”‚ SΓ΅numid kΓ€rgvΓ΅rgust β†’ MQTT maakler β”‚
β”‚ Allalink β”‚ SΓ΅numid MQTT maaklerist β†’ kΓ€rgvΓ΅rk β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Configure per-channel which directions are active to control message flow and airtime usage.

Message Formats

MQTT kasutab protobuf-sΓ΅numivormingut:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Format β”‚ Kirjeldus β”‚ Use case β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Protobuf β”‚ Binaarne Meshtastic protobuf kodeering β”‚ Node-to-node mesh bridging β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

β”‚ ⚠️ MΓ€rkus: JSON vΓ€ljundi tugi eemaldati pΓΌsivarast. The T383838json_enabled setting is still visible in
β”‚ the app for legacy compatibility but has no effect on current firmware versions.

Encryption & Privacy

Understanding the layered encryption model:

1. Kanali krΓΌptimine toimub kΓ€rgvΓ΅rgus enne MQTT. Kui kanalil on PSK, on ​​MQTT liiklus juba krΓΌptitud – maakler ja kΓ΅ik tellijad nΓ€evad ainult Ε‘ifriteksti.
2. MQTT krΓΌptimine (mooduli sΓ€te) lisab vahendajale edastamiseks tΓ€iendava krΓΌptimiskihi. This protects metadata and routing information.
3. TLS krΓΌpteerib TCP ΓΌhenduse vahendaja endaga, takistades vΓ΅rgutasandil pealtkuulamist.

β”‚ πŸ”’ TΓ€htis: Vaikimisi avalikul kanalil on tuntud vΓ΅ti. MQTT kaudu saadetud vaikekanalil olevad
β”‚ sΓ΅numid on sisuliselt krΓΌpteerimata – igaΓΌks saab neid dekodeerida. Always use a custom PSK for
β”‚ private communications.

Best Practices

β€’ Kasuta kanali krΓΌptimist (PSK), kanalitel mis on sillatud MQTT-ga
β€’ Γ„ra luba MQTT internetiΓΌhenduseta sΓ΅lmedel (see puhverdab ja raiskab mΓ€lu)
β€’ Use a private broker for sensitive deployments
β€’ MQTT sΓ΅numite allalaadimisel arvesta eetriaja kuluga – iga allalingitud sΓ΅num tarbib sinu kohalikus vΓ΅rgus raadioeetriaega
β€’ Kaalu ainult ΓΌleslingi lubamist, kui sul on vaja oma kΓ€rgvΓ΅rku eemalt jΓ€lgida ilma sΓ΅numeid tagasi tΓ΅mbamata

Troubleshooting

MQTT ei ΓΌhendu

β€’ Kontrolli WiFit – lΓΌΓΌssΓ΅lmel peab olema aktiivne internetiΓΌhendus (WiFi vΓ΅i Ethernet). MQTT ei tΓΆΓΆta LoRa raadiolingi enda kaudu.
β€’ Verify credentials β€” incorrect username or password will silently fail on most brokers. Double-check for trailing spaces.
β€’ TulemΓΌΓΌr β€” port 1883 (MQTT) vΓ΅i 8883 (MQTT+TLS) peab olema avatud. Some networks block non-standard ports.
β€’ DNS resolution β€” if using a custom broker hostname, verify the node can resolve it. Try the broker's IP address directly.

Messages Not Bridging

β€’ Kontrolli ΓΌleslingi/allalingi seadeid β€” kui lubatud on ainult ΓΌleslink, liiguvad sΓ΅numid vΓ΅rgust MQTT-sse, aga mitte tagasi. Luba vastuvΓ΅tval lΓΌΓΌsil allalink.
β€’ Channel mismatch β€” both gateways must share the same channel with the same PSK. A mismatch means messages are encrypted with different keys and appear as garbage.
β€’ Topic mismatch β€” ensure both gateways use the same root topic. The default T383838msh works for the public broker.

Related Topics

β€’ Seaded β€” Moodulid ja administreerimine β€” MQTT mooduli konfi viide
β€’ SΓ΅numid ja kanalid β€” kanali krΓΌptimine ja PSK seadistamine
β€’ MQTT integratsioonijuhend β€” ΓΌksikasjalik MQTT dokumentatsioon aadressil meshtastic.org


Served by rngit 1.5.2 - Generated in 0.09s